home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Almathera Ten Pack 3: CDPD 3
/
Almathera Ten on Ten - Disc 3: CDPD3.iso
/
jam
/
jamdisk8
/
frqlib
/
fr_bypass.doc
< prev
next >
Wrap
Text File
|
1995-03-18
|
5KB
|
152 lines
---------------------
| FR Bypass 3.02 |
| |
| By: Khalid Aldoseri |
---------------------
FR_Bypass allows the file requester in 'kd_freq.library' to be used with
many programs that use other file requesters in libraries.
FR_Bypass will replace the file requesters in the following libraries:
arp.library The ARP file requester.
req.library The file requester that comes with CED Pro 2.
asl.library The standard file requester in AmigaDOS 2.0 and above.
Once the bypass is installed, every time a program calls any of the above
file requesters, mine will come up instead!
Installation:
-------------
Copy FR_Bypass to your C: directory, and add it to your startup-sequence.
A window will come up informing you of the success of its installation.
If it says 'Installation failed' then 'kd_freq.library' wasn't in the
LIBS: directory. Otherwise it will report the libraries found and bypassed.
This can be something like this:
'Installed: ARP REQ ASL Injector'
It will not allow you to run multiple copies of itself. You can quit it at
any time by hitting 'right shift-right alt-q'.
Required files:
---------------
File name Optional? Version
-------------------- --------- ------------
LIBS:kd_freq.library Mandatory 3 or above
LIBS:asl.library Optional 36 or above
LIBS:arp.library Optional any version
LIBS:req.library Optional any version
Startup options:
----------------
You can disable bypassing of a specific library, or disabling the Inject
facility by adding a specific letter to the <options> as follows:
FR_Bypass <options>
FR_Bypass q Disables req.library bypass.
FR_Bypass p Disables arp.library bypass.
FR_Bypass l Disables asl.library bypass.
FR_Bypass i Disables injector.
FR_Bypass w Do not show startup window.
(error reports will still be shown)
Options can be grouped by using multiple letters in <options>. i.e.
FR_Bypass lq Disables asl.library & req.library bypass.
Programmer's Note:
------------------
FR_Bypass allows you to code for a standard file requester, like the
asl.library requester, and still allow users access to a high-powered
file requester if they wants one.
You do not have to worry about my library at all. All you need to do
is to code as usual for one of the above libraries and FR_Bypass will
handle the differences in calling procedures between that FR and my FR.
e.g. In the case or ARP, it will trap the normal ARP FR call, read the
ARP FileRequester structure, set the right calling procedure for my FR,
call my FR, return from it, and set the right results in ARP format,
and return the call to your program. Your program will not know the
difference. Of course, using this technique has one disadvantage:
You cannot use some special features of my FR, like extended select.
FR_Bypass traps the official entry points into asl.library, namely
RequestFile() and AslRequest(). AslRequestTags() is simply a stub that
calls AslRequest(), so it is automatically trapped as well.
Limitations:
------------
If the bypass code cannot handle a specific situation, e.g. if the
req.library call is used to bring up a font requester, Bypass will
call the original file requester since my f-r cannot handle this
request reasonably.
FR_Bypass currently doesn't handle multi-file requests from req.library
or asl.library. The next version will hopefully fix that.
File Injector:
--------------
This uses my FR to allow you to select a directory/file at any time and
'inject' its name into the keyboard stream.
To invoke the FR hit the 'right shift-right alt-r' key and the FR will show
up on the front screen. You then select a file from the requester and click
on OK.
After that, you can, at any time, hit the 'right shift-right alt-s' key and
Inject will feed the directory/filename into the keyboard stream. You can
also feed only the directory name by using the 'right shift-right alt-d' key
or the filename alone by using the 'right shift-right alt-f' key.
If the string to be output contains a space then it will be surrounded with
double quotes.
Summary of functions: (all keys are with right shift-right alt combo)
Key Action
--- --------------------------
r Call up file requester.
s Inject directory+filename.
d Inject directory.
f Inject filename.
q Quit (unload) program.
Note that the 'q' key still works even if the inject facility is disabled
with the 'FR_Bypass i' command.
---------------------------------------
| Copyright 1990,1991 Khalid Aldoseri. |
| 17 Nov 1991. |
---------------------------------------
CygnusEd Professional & CED are Copyright 1987,1988,1989 CygnusSoft Software.
ARP is Copyright 1987,1988,1989 by ARP Authors.
Req.library was written by Colin Fox (of Pyramyd Designs) and Bruce Dawson
(of CygnusSoft Software).
asl.library comes with AmigaDOS version 2.0 and above.
I believe this is Copyright CBM.